/*
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.schema.domain.thing;

import java.util.Date;
import org.schema.domain.Thing;
import org.schema.domain.thing.Event;
import org.schema.domain.thing.Organization;
import org.schema.domain.thing.Person;
import org.schema.domain.thing.intangible.structuredValue.ContactPoint;
import org.schema.domain.thing.intangible.structuredValue.contactPoint.PostalAddress;
import org.schema.domain.thing.organization.EducationalOrganization;
import org.schema.domain.thing.place.administrativeArea.Country;

/**
 * A person (alive, dead, undead, or fictional).
 */
public interface Person extends Thing {

	/**
	 * An additional name for a Person, can be used for a middle name.
	 *
 	 * @return String
	 */
	String getAdditionalName();

	/**
	 * An additional name for a Person, can be used for a middle name.
	 *
 	 * @param string
	 * @return void
	 */
	void setAdditionalName(String string);

	/**
	 * Physical address of the item.
	 *
 	 * @return PostalAddress
	 */
	PostalAddress getAddress();

	/**
	 * Physical address of the item.
	 *
 	 * @param postalAddress
	 * @return void
	 */
	void setAddress(PostalAddress postalAddress);

	/**
	 * An organization that this person is affiliated with. For example, a school/university, a club, or a team.
	 *
 	 * @return Organization
	 */
	Organization getAffiliation();

	/**
	 * An organization that this person is affiliated with. For example, a school/university, a club, or a team.
	 *
 	 * @param organization
	 * @return void
	 */
	void setAffiliation(Organization organization);

	/**
	 * An educational organizations that the person is an alumni of.
	 *
 	 * @return EducationalOrganization
	 */
	EducationalOrganization getAlumniOf();

	/**
	 * An educational organizations that the person is an alumni of.
	 *
 	 * @param educationalOrganization
	 * @return void
	 */
	void setAlumniOf(EducationalOrganization educationalOrganization);

	/**
	 * Awards won by this person or for this creative work.
	 *
 	 * @return String
	 */
	String getAwards();

	/**
	 * Awards won by this person or for this creative work.
	 *
 	 * @param string
	 * @return void
	 */
	void setAwards(String string);

	/**
	 * Date of birth.
	 *
 	 * @return Date
	 */
	Date getBirthDate();

	/**
	 * Date of birth.
	 *
 	 * @param date1
	 * @return void
	 */
	void setBirthDate(Date date1);

	/**
	 * A child of the person.
	 *
 	 * @return Person
	 */
	Person getChildren();

	/**
	 * A child of the person.
	 *
 	 * @param person
	 * @return void
	 */
	void setChildren(Person person);

	/**
	 * A colleague of the person.
	 *
 	 * @return Person
	 */
	Person getColleagues();

	/**
	 * A colleague of the person.
	 *
 	 * @param person
	 * @return void
	 */
	void setColleagues(Person person);

	/**
	 * A contact point for a person or organization.
	 *
 	 * @return ContactPoint
	 */
	ContactPoint getContactPoints();

	/**
	 * A contact point for a person or organization.
	 *
 	 * @param contactPoint
	 * @return void
	 */
	void setContactPoints(ContactPoint contactPoint);

	/**
	 * Date of death.
	 *
 	 * @return Date
	 */
	Date getDeathDate();

	/**
	 * Date of death.
	 *
 	 * @param date1
	 * @return void
	 */
	void setDeathDate(Date date1);

	/**
	 * Email address.
	 *
 	 * @return String
	 */
	String getEmail();

	/**
	 * Email address.
	 *
 	 * @param string
	 * @return void
	 */
	void setEmail(String string);

	/**
	 * Family name. In the U.S., the last name of an Person. This can be used along with givenName instead of the Name property.
	 *
 	 * @return String
	 */
	String getFamilyName();

	/**
	 * Family name. In the U.S., the last name of an Person. This can be used along with givenName instead of the Name property.
	 *
 	 * @param string
	 * @return void
	 */
	void setFamilyName(String string);

	/**
	 * The fax number.
	 *
 	 * @return String
	 */
	String getFaxNumber();

	/**
	 * The fax number.
	 *
 	 * @param string
	 * @return void
	 */
	void setFaxNumber(String string);

	/**
	 * The most generic uni-directional social relation.
	 *
 	 * @return Person
	 */
	Person getFollows();

	/**
	 * The most generic uni-directional social relation.
	 *
 	 * @param person
	 * @return void
	 */
	void setFollows(Person person);

	/**
	 * Gender of the person.
	 *
 	 * @return String
	 */
	String getGender();

	/**
	 * Gender of the person.
	 *
 	 * @param string
	 * @return void
	 */
	void setGender(String string);

	/**
	 * Given name. In the U.S., the first name of a Person. This can be used along with familyName instead of the Name property.
	 *
 	 * @return String
	 */
	String getGivenName();

	/**
	 * Given name. In the U.S., the first name of a Person. This can be used along with familyName instead of the Name property.
	 *
 	 * @param string
	 * @return void
	 */
	void setGivenName(String string);

	/**
	 * A contact location for a person's residence.
	 *
 	 * @return Thing
	 */
	Thing getHomeLocation();

	/**
	 * A contact location for a person's residence.
	 *
 	 * @param thing
	 * @return void
	 */
	void setHomeLocation(Thing thing);

	/**
	 * An honorific prefix preceding a Person's name such as Dr/Mrs/Mr.
	 *
 	 * @return String
	 */
	String getHonorificPrefix();

	/**
	 * An honorific prefix preceding a Person's name such as Dr/Mrs/Mr.
	 *
 	 * @param string
	 * @return void
	 */
	void setHonorificPrefix(String string);

	/**
	 * An honorific suffix preceding a Person's name such as M.D. /PhD/MSCSW.
	 *
 	 * @return String
	 */
	String getHonorificSuffix();

	/**
	 * An honorific suffix preceding a Person's name such as M.D. /PhD/MSCSW.
	 *
 	 * @param string
	 * @return void
	 */
	void setHonorificSuffix(String string);

	/**
	 * A count of a specific user interactions with this item—for example, 20 UserLikes, 5 UserComments, or 300 UserDownloads. The user interaction type should be one of the sub types of UserInteraction.
	 *
 	 * @return String
	 */
	String getInteractionCount();

	/**
	 * A count of a specific user interactions with this item—for example, 20 UserLikes, 5 UserComments, or 300 UserDownloads. The user interaction type should be one of the sub types of UserInteraction.
	 *
 	 * @param string
	 * @return void
	 */
	void setInteractionCount(String string);

	/**
	 * The job title of the person (for example, Financial Manager).
	 *
 	 * @return String
	 */
	String getJobTitle();

	/**
	 * The job title of the person (for example, Financial Manager).
	 *
 	 * @param string
	 * @return void
	 */
	void setJobTitle(String string);

	/**
	 * The most generic bi-directional social/work relation.
	 *
 	 * @return Person
	 */
	Person getKnows();

	/**
	 * The most generic bi-directional social/work relation.
	 *
 	 * @param person
	 * @return void
	 */
	void setKnows(Person person);

	/**
	 * An organization to which the person belongs.
	 *
 	 * @return Organization
	 */
	Organization getMemberOf();

	/**
	 * An organization to which the person belongs.
	 *
 	 * @param organization
	 * @return void
	 */
	void setMemberOf(Organization organization);

	/**
	 * Nationality of the person.
	 *
 	 * @return Country
	 */
	Country getNationality();

	/**
	 * Nationality of the person.
	 *
 	 * @param country
	 * @return void
	 */
	void setNationality(Country country);

	/**
	 * A parents of the person.
	 *
 	 * @return Person
	 */
	Person getParents();

	/**
	 * A parents of the person.
	 *
 	 * @param person
	 * @return void
	 */
	void setParents(Person person);

	/**
	 * Event that this person is a performer or participant in.
	 *
 	 * @return Event
	 */
	Event getPerformerIn();

	/**
	 * Event that this person is a performer or participant in.
	 *
 	 * @param event
	 * @return void
	 */
	void setPerformerIn(Event event);

	/**
	 * The most generic familial relation.
	 *
 	 * @return Person
	 */
	Person getRelatedTo();

	/**
	 * The most generic familial relation.
	 *
 	 * @param person
	 * @return void
	 */
	void setRelatedTo(Person person);

	/**
	 * A sibling of the person.
	 *
 	 * @return Person
	 */
	Person getSiblings();

	/**
	 * A sibling of the person.
	 *
 	 * @param person
	 * @return void
	 */
	void setSiblings(Person person);

	/**
	 * The person's spouse.
	 *
 	 * @return Person
	 */
	Person getSpouse();

	/**
	 * The person's spouse.
	 *
 	 * @param person
	 * @return void
	 */
	void setSpouse(Person person);

	/**
	 * The telephone number.
	 *
 	 * @return String
	 */
	String getTelephone();

	/**
	 * The telephone number.
	 *
 	 * @param string
	 * @return void
	 */
	void setTelephone(String string);

	/**
	 * A contact location for a person's place of work.
	 *
 	 * @return Thing
	 */
	Thing getWorkLocation();

	/**
	 * A contact location for a person's place of work.
	 *
 	 * @param thing
	 * @return void
	 */
	void setWorkLocation(Thing thing);

	/**
	 * Organizations that the person works for.
	 *
 	 * @return Organization
	 */
	Organization getWorksFor();

	/**
	 * Organizations that the person works for.
	 *
 	 * @param organization
	 * @return void
	 */
	void setWorksFor(Organization organization);

}